.TH E1432_GET_CURRENT_DATA 3 E1432
.SH NAME
.nf
e1432_get_current_data \- Get current measurement data block
.IX e1432_get_current_data(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_get_current_data(E1432ID hw, SHORTSIZ16 ID,
                                  SHORTSIZ16 data_type, SHORTSIZ16 data_size,
                                  void **data, LONGSIZ32 *actual_count)
.cE
.SH DESCRIPTION

\fIe1432_get_current_data\fR gets the most recent measurement data blocks
for the channel(s) selected by \fIID\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.
It specifies which channel(s) to get current measurement data for.

\fIdata_type\fR specifies which type of measurement data is requested.
Currently, only \fBE1432_OCTAVE_DATA\fR is supported.

\fIdata_size\fR specifies the type of numerical format that is requested.
Currently, only \fBE1432_DATA_SIZE_FLOAT32\fR and
\fBE1432_DATA_SIZE_FLOAT64\fR are supported.

\fIdata\fR points to an array of pointers to the memory blocks
which are to receive the measurement data.
All channels specified by \fIID\fR
must have a pointer in the array pointed to by \fIdata\fR.
The memory blocks pointed to by those pointers
must have enough space to receive the measurement data.
The channel ordering is the same as that provided in the
e1432_create_channel_group function call used to create \fIID\fR,
with no gaps for unused channels.

For \fIdata_type\fR \fBE1432_OCTAVE_DATA\fR, with linear averaging,
as set by \fIe1432_set_octave_avg_mode\fR or Octave hold modes other than 
\fBE1432_OCTAVE_HOLD_MODE_OFF\fR, as set by \fIe1432_set_octave_hold_mode\fR,
data may be either the instantaneous Octave value or the averaged/hold mode
result, depending on which is most recently available.

The actual number of data points read into each block is returned in the
memory location pointed to by \fIactual_count\fR.

.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_octave_mode,
e1432_set_octave_avg_mode,
e1432_set_octave_hold_mode,
e1432_set_octave_start_freq, e1432_set_octave_stop_freq,
e1432_set_octave_int_time,
e1432_set_octave_time_const,
e1432_set_octave_time_step,
e1432_octave_ctl,
e1432_get_octave_blocksize
.ad
